NewAlias

NewAlias
Header:	Aliases.h		Carbon status:	Supported

Creates a complete alias record.

OSErr NewAlias (
    ConstFSSpecPtr fromFile, 
    const FSSpec *target, 
    AliasHandle *alias
);

fromFile: The starting point for a relative path, to be used later in a relative search. If you do not need relative path information in the structure, pass a fromFile value of NULL. If you want NewAlias to record relative path information, pass a pointer to a valid FSSpec record in this parameter. The two files or directories, fromFile and target, must reside on the same volume.
target: An FSSpec record for the target of the alias record.
alias: A handle to the newly created alias record. If the function fails to create an alias record, it sets alias to NULL.

function result: A result code.

DISCUSSION

The NewAlias function creates an alias record that describes the specified target. It allocates the storage, fills in the record, and puts a record handle to that storage in the alias parameter. NewAlias always records the name and file or directory ID of the target, its creation date, the parent directory name and ID, and the volume name and creation date. It also records the full pathname of the target and a collection of other information relevant to locating the target, verifying the target, and mounting the target’s volume, if necessary. You can have NewAlias store relative path information as well by supplying a starting point for a relative path.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.